PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager


MyThemeIteratorProc

Performs a custom response to an iteration over themes installed on a system.

Here's how to declare a theme iteration function, if you were to name the function MyThemeIteratorProc :

pascal Boolean MyThemeIteratorProc (
                     ConstStr255Param inFileName,
                     SInt16 resID,
                     Collection inThemeSettings,
                     void *inUserData);
inFileName
A value of type ConstStr255Param . You are passed the name of the file containing the theme being iterated upon.
resID
A signed 16-bit integer. You are passed the resource ID of the theme.
inThemeSettings
A value of type Collection . You are passed a reference to a collection that contains data describing attributes of the theme. Note that the Appearance Manager owns this collection, and that your application should not dispose of it.
inUserData
A pointer to data of any type. You are passed the value specified in the inUserData parameter of the function IterateThemes .
function result
A value of type Boolean . If you return true , IterateThemes continues iterating. Set to false to terminate the iteration.
SPECIAL CONSIDERATIONS

Your application should not open and close theme files during this call.

VERSION NOTES

Available with Appearance Manager 1.1 and later.


© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)